home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / plst_133.arc / PARSELST.DOC < prev    next >
Text File  |  1991-09-27  |  36KB  |  842 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                       +---+-------------------------------
  18.                                       | o |
  19.                                       |   |  Zone,1,Intl_FidoNet_Co,Phoeni
  20.                                       | o |  ,1,FidoNews,FidoNews_Editor,D
  21.          ParseLst Version 1.30        |   |  ,2,Euro_Gate,Portland_OR,Rand
  22.                                       | o |  ,3,OZ_Gate,Portland_OR,Randy_
  23.          A Nodelist Processing        |   |  ,10,Int'l_FNet_Assn,St_Louis_
  24.          Program by Bob Hartman       | o |  ,11,IFNA_Finance,Honolulu_HI,
  25.                                       |   |  ,12,IFNA_Legal,Parsippany_NJ,
  26.          Documentation Written        | o |  ,16,IFNA_Mem._Data,Clevland_O
  27.          by Alan Applegate            |   |  ,17,IFNA_Mem._Info,Clevland_O
  28.                                       | o |  ,20,Fido_Tech_Stand,Portland_
  29.                                       |   |  ,100,General_Help,Clifton_NJ,
  30.                                       | o |  ,102,BinkleyTERM_Help,Chattan
  31.                                       |   |  ,113,OPUS_Info,Chico_CA,Doug_
  32.                                       | o |  ,114,Quick_BBS_Help,Floral_Pa
  33.                                       |   |  ,116,Dutchie_Help,CapeGirarde
  34.                                       | o |  ,117,Fido_Help,San_Jose_CA,Jo
  35.                                       |   |  ,200,Nat'l_Echo_Coor,Concord_
  36.                                       | o |  ,201,EchoList_Coord,Toms_Rive
  37.                                       |   |
  38.                                       |  /\  /\/\/\/\/\  /\/\/\    /\  /\/
  39.                                        \/  \/          \/      \  /  \/
  40.                                                                 \/
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                  ParseLst - Page 1
  58.  
  59.          TABLE OF CONTENTS
  60.  
  61.          Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  2
  62.          Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  63.          Operation  . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  64.          Configuration File . . . . . . . . . . . . . . . . . . . . . .  4
  65.               Node  . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  66.               Country . . . . . . . . . . . . . . . . . . . . . . . . .  4
  67.     NEW!      Complete, Gated . . . . . . . . . . . . . . . . . . . . .  5
  68.               UseZone . . . . . . . . . . . . . . . . . . . . . . . . .  5
  69.     NEW!      Version5, Version6, TBBSList, QuickBBSList, BinkList  . .  5
  70.               Nodelist, NoNodelist  . . . . . . . . . . . . . . . . . .  6
  71.               UserList, InterList, NoUserList . . . . . . . . . . . . .  6
  72.               FidoTxt, FidoPrn, NoFidoList  . . . . . . . . . . . . . .  6
  73.               Report, NoReport  . . . . . . . . . . . . . . . . . . . .  6
  74.               Comments, NoComments  . . . . . . . . . . . . . . . . . .  7
  75.               Dash, NoDash  . . . . . . . . . . . . . . . . . . . . . .  7
  76.               Route, NoRoute  . . . . . . . . . . . . . . . . . . . . .  7
  77.               MaxBaud . . . . . . . . . . . . . . . . . . . . . . . . .  7
  78.               MyList, PvtList . . . . . . . . . . . . . . . . . . . . .  7
  79.               Igate, Ogate, Gate, Hub . . . . . . . . . . . . . . . . .  8
  80.               Password  . . . . . . . . . . . . . . . . . . . . . . . .  8
  81.               Phone . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  82.               Baud  . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  83.               CM  . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  84.               Dial  . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  85.               Cost  . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  86.               Include . . . . . . . . . . . . . . . . . . . . . . . . . 13
  87.          Nodelist Generation for Your System  . . . . . . . . . . . . . 13
  88.          Command Line Parameters  . . . . . . . . . . . . . . . . . . . 14
  89.          Product Support  . . . . . . . . . . . . . . . . . . . . . . . 14
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                  ParseLst - Page 2
  114.  
  115.          INTRODUCTION
  116.          
  117.          ParseLst is a program for processing a FidoNet nodelist.  
  118.          ParseLst uses a control file to process the information contained 
  119.          in a raw, "St. Louis" nodelist, and turn the information into a 
  120.          form usable by several FidoNet compatible BBS and mailer 
  121.          packages, including BinkleyTerm, Opus-CBCS, TBBS and QuickBBS.  
  122.  
  123.          ParseLst is capable of producing so-called "new Opus style" 
  124.          (Version 6) nodelist files for use with BinkleyTerm 1.21 and 
  125.          above, and Opus-CBCS 1.30 and above. 
  126.          
  127.          ParseLst provides complete one-step processing of a FidoNet 
  128.          nodelist into a form usable by a given BBS or mailer package.  
  129.          This functionality includes updating the nodelist based on 
  130.          information provided by NODEDIFF update files, distributed weekly 
  131.          within FidoNet.
  132.          
  133.          ParseLst is capable of operating with an XlatList-style control 
  134.          file, and supports most of the functions available with XlatList. 
  135.          
  136.          NOTICE
  137.          
  138.          ParseLst is not supplied with any sort of guarantee.  You use 
  139.          ParseLst at your own risk.  
  140.          
  141.          The following names are either trademarks or the work of the 
  142.          individuals and/or companies shown: 
  143.          
  144.          FidoNet - Tom Jennings and Fido Software 
  145.          Opus-CBCS - Wynn Wagner 
  146.          RouteGen, XlatList, SEAdog - Thom Henderson and System 
  147.               Enhancement Associates, Inc. 
  148.          TBBS - Phil Becker, eSoft, Inc.
  149.          QuickBBS - Adam Hudson
  150.  
  151.          
  152.          
  153.          
  154.          
  155.          
  156.          
  157.          
  158.          
  159.          
  160.          
  161.          
  162.          
  163.          
  164.          
  165.          
  166.          
  167.          
  168.          
  169.                                  ParseLst - Page 3
  170.  
  171.          OPERATION
  172.  
  173.          ParseLst requires a configuration file, PARSELST.CFG, to be 
  174.          available to the program at run-time.  This file has in it the 
  175.          various control parameters required to customize the output of 
  176.          ParseLst to your specifications. 
  177.  
  178.          When invoked, ParseLst will search the current directory for 
  179.          NODEDIFF.nnn files whose julian date is one week later than the 
  180.          latest numbered NODELIST.nnn file.  The "nnn" is three digits 
  181.          that correspond to the julian date when the NODELIST or NODEDIFF 
  182.          file was produced.  If such a NODEDIFF exists, ParseLst will 
  183.          apply the changes to the NODELIST, and create a new NODELIST.nnn 
  184.          file with the same number as the NODEDIFF used for the update. 
  185.  
  186.          ParseLst will produce various output as directed by the 
  187.          configuration file.  Although ParseLst can produce the familiar 
  188.          NODELIST.BBS file of other nodelist processors, the user will 
  189.          usually desire finished, ready-to-use nodelist files.  ParseLst 
  190.          can produce these compiled nodelist files: 
  191.  
  192.               Opus Version 6      NODELIST.DAT, NODELIST.IDX
  193.               Opus Version 5      NODELIST.SYS, NODELIST.IDX
  194.               TBBS                INDEX.DOG, NETLIST.DOG, NODELIST.DOG
  195.               QuickBBS            QNL_DAT.BBS, QNL_IDX.BBS
  196.  
  197.          ParseLst can also produce special supplemental nodelist data 
  198.          files to be used with BinkleyTerm when the master nodelist in use 
  199.          does not contain complete information (as is required when using 
  200.          the TBBS nodelist files with BinkleyTerm).
  201.  
  202.          ParseLst is different from some other nodelist processors, in 
  203.          that it will NEVER output an "unpublished" node.  Instead, 
  204.          ParseLst substitutes the information for the unpublished node's 
  205.          host (phone number, baud rate, flags, etc.).  If the unpublished 
  206.          number is for an independent, the node is omitted from the final 
  207.          list - no mail can be sent to an independent node without the 
  208.          proper phone number.  This way, the mail will always go out (even 
  209.          crash mail on systems that support the nodelist flags) without 
  210.          problems. 
  211.  
  212.          
  213.          
  214.          
  215.          
  216.          
  217.          
  218.          
  219.          
  220.          
  221.          
  222.          
  223.          
  224.          
  225.                                  ParseLst - Page 4
  226.  
  227.          CONFIGURATION FILE
  228.          
  229.          In this section, we describe the configuration file options 
  230.          available for ParseLst.  
  231.          
  232.          In many local nets within FidoNet, XlatList control files are 
  233.          "shared" among Sysops.  Since the control files can be rather 
  234.          complicated and lengthy, it might be wise to check with other 
  235.          Sysops in your area to see if they can supply you with a working 
  236.          XlatList control file.  Since ParseLst can use the same file with 
  237.          minimal changes, all you'll need to do is customize the control 
  238.          file for your application, rename it PARSELST.CFG, and run the 
  239.          program. 
  240.          
  241.          The options are explained here for reference.  NOTE:  ParseLst 
  242.          DOES NOT support the following parameters: 
  243.  
  244.               Addr
  245.               Index
  246.               Sindex
  247.               NoIndex
  248.               CleanUp
  249.               Ozone
  250.               PubList
  251.               Points
  252.  
  253.          Note also that the names of the various parameters are shown as 
  254.          they are for visual clarity.  In practice, the configuration file 
  255.          is NOT case sensitive.  Items in square brackets ([]) are optional. 
  256.  
  257.                               Node [<zone>:]<net>/<node> 
  258.  
  259.          Example:  Node 1:3000/45 
  260.          
  261.          This informs ParseLst where you're located.  This is a full 
  262.          network address.  In the example above, "1" is the zone, "3000" 
  263.          is the net, and "45" is the node.  If the zone number is left 
  264.          out, the resulting nodelist will not have zones present.  
  265.          Instead, the appearances of the ZONE keyword will be converted to 
  266.          the REGION keyword. 
  267.  
  268.                                  Country <country> 
  269.  
  270.          Example:  Country 1 
  271.  
  272.          This tells ParseLst what country you're in.  In the various 
  273.          dialing and cost tables, this entry defines what would qualify as 
  274.          an "international" call.  For the United States, "1" is the 
  275.          correct entry, and is the default value. 
  276.  
  277.          
  278.          
  279.          
  280.          
  281.                                  ParseLst - Page 5
  282.  
  283.          CONFIGURATION FILE (Continued)
  284.          
  285.                                       Complete  <-- Default
  286.                                        Gated
  287.  
  288.          This tells ParseLst how much zone information to include in its 
  289.          output files.  'Complete' will place node information from ALL 
  290.          zones in the raw nodelist into any ParseLst output.  'Gated' will 
  291.          place node information from YOUR ZONE ONLY in the raw nodelist 
  292.          into any ParseLst output.
  293.  
  294.                                       UseZone
  295.  
  296.          This tells ParseLst to keep the ZONE keyword as it appears in the 
  297.          raw nodelist in the proper place inside the NODELIST.BBS file, if 
  298.          generated. 
  299.  
  300.          If NOT used, the ZONE keyword will be replaced with the keyword 
  301.          REGION in the resulting NODELIST.BBS file. 
  302.  
  303.          If the 'NoNodelist' statement is used in PARSELST.CFG, this 
  304.          statement will have no effect. 
  305.  
  306.                                       Version5
  307.                                       Version6
  308.                                       TBBSList
  309.                                     QuickBBSList
  310.                                       BinkList
  311.  
  312.          These options tell ParseLst to directly produce compiled nodelist 
  313.          output.  
  314.          
  315.          'Version5' will produce NODELIST.IDX and NODELIST.SYS files.  
  316.          These are compatible with Fido Version 11w, Opus 1.03a, and 
  317.          BinkleyTerm 1.30 and earlier. 
  318.  
  319.          'Version6' will produce NODELIST.IDX and NODELIST.DAT files.  
  320.          These are compatible with Opus 1.30 and later, and BinkleyTerm 
  321.          1.21 and later. 
  322.  
  323.          'TBBSList' will produce INDEX.DOG, NETLIST.DOG and NODELIST.DOG 
  324.          as used by TBBS.
  325.  
  326.          'QuickBBSList' will produce QNL_IDX.BBS and QNL_DAT.BBS as used 
  327.          by QuickBBS 2.01 and later.  
  328.  
  329.          'BinkList' will produce NODELIST.IDX and NODELIST.EXT, special 
  330.          supplemental nodelist data files for use with BinkleyTerm, when 
  331.          the main nodelist in use does not support complete information.  
  332.          For example, when using a TBBS style nodelist for use with 
  333.          BinkleyTerm 1.50 or later, you must use BOTH the 'BinkList' and 
  334.          'TBBSList' options.
  335.  
  336.          
  337.                                  ParseLst - Page 6
  338.  
  339.          CONFIGURATION FILE (Continued)
  340.          
  341.          Note that one or more of these options can be used simultaneously 
  342.          to produce output of multiple types.  The format of NODELIST.IDX 
  343.          is the same in all cases, and can used simultaneously.  The 
  344.          default is not to generate any of these files.
  345.  
  346.                                       Nodelist  <-- Default 
  347.                                      NoNodelist 
  348.  
  349.          This tells ParseLst whether or not to output a NODELIST.BBS file 
  350.          as the result of nodelist processing.  If you're using the 
  351.          options explained above for processing to a compiled nodelist 
  352.          format you probably will not need the NODELIST.BBS file at all. 
  353.          
  354.          
  355.                                       UserList
  356.                                      InterList
  357.                                      NoUserList  <-- Default 
  358.  
  359.          These options inform ParseLst to create (or not to create) 
  360.          various listings of Sysops in the raw nodelist.  
  361.          
  362.          'UserList' will generate a file called FIDOUSER.LST that contains 
  363.          the names and node addresses of the Sysops in your zone. 
  364.          
  365.          'InterList' will generate a file called FIDOUSER.LST that 
  366.          contains the names and node addresses of ALL the Sysops in ALL 
  367.          zones. 
  368.          
  369.          'NoUserList' will generate no such listing at all. 
  370.          
  371.          The default value is 'NoUserList.'  Please note that QSORT, a 
  372.          program by Ben Baker, needs to be available to ParseLst in order 
  373.          to complete the processing of FIDOUSER.LST if you have one of the 
  374.          options enabled. 
  375.  
  376.                                       FidoTxt
  377.                                       FidoPrn
  378.                                      NoFidoList  <-- Default
  379.  
  380.          This tells ParseLst whether or not to produce a human readable 
  381.          nodelist report.  'FidoTxt' produces an 80-column version of the 
  382.          report, NODELIST.TXT.  'FidoPrn' produces a 132-column version of 
  383.          the report NODELIST.PRN.  'NoFidoList' is the default value, and 
  384.          tells ParseLst not to produce any such report. 
  385.  
  386.                                        Report  <-- Default
  387.                                       NoReport
  388.  
  389.          This tells ParseLst whether or not to display a report outlining 
  390.          the number of nets, nodes and other information that the program 
  391.          has processed.  Output can be redirected at the ParseLst command 
  392.          line to a printer or file. 
  393.                                  ParseLst - Page 7
  394.  
  395.          CONFIGURATION FILE (Continued)
  396.  
  397.                                       Comments
  398.                                      NoComments  <-- Default
  399.          
  400.          This tells ParseLst whether or not to display the comments in the 
  401.          raw nodelist (comments frequently contain timely information from 
  402.          the Zone Coordinator).  Output can be redirected at the ParseLst 
  403.          command line to a printer or file. 
  404.          
  405.                                         Dash  <-- Default 
  406.                                        NoDash 
  407.  
  408.          This tells ParseLst whether or not to retain the hyphens found in 
  409.          nodelist telephone number entries.  Leaving them out saves some 
  410.          space in the output file(s) that ParseLst may produce.  Some 
  411.          modems also have limitations on the length of the dial string 
  412.          which may necessitate the use of the 'NoDash' option. 
  413.  
  414.                                        Route
  415.                                       NoRoute  <-- Default
  416.          
  417.          This tells ParseLst whether or not to output a data file for use 
  418.          by System Enhancement Associates' RouteGen program.  The name of 
  419.          the data file will be NODELIST.FON if this option is enabled. 
  420.          
  421.                                    MaxBaud <baud> 
  422.  
  423.          Example:  MaxBaud 2400 
  424.                   
  425.          This tells ParseLst the maximum baud rate you're capable of 
  426.          supporting.  Baud rates in the nodelist that are higher than this 
  427.          value are changed to it in ParseLst's output. 
  428.  
  429.                                  MyList <filename> 
  430.                                  PvtList <filename> 
  431.  
  432.          Example:  PvtList mylist.lst 
  433.  
  434.          These options tell ParseLst the names of raw nodelist files that 
  435.          are to be processed with the primary nodelist.  The designated 
  436.          nodelists must be in the same format as the primary list 
  437.          (following FidoNet specifications).  You may use multiple 
  438.          'MyList' and 'PvtList' entries in the configuration file if 
  439.          desired.  The two options work the same way, except: 
  440.          
  441.          When 'MyList' is used, information about the list is included in 
  442.          the reports generated by ParseLst. 
  443.          
  444.          When 'PvtList' is used, information about the list is NOT 
  445.          included in the reports generated by ParseLst. 
  446.  
  447.          
  448.          
  449.                                  ParseLst - Page 8
  450.  
  451.          CONFIGURATION FILE (Continued)
  452.          
  453.          ParseLst will not search for a "latest" listing if these options 
  454.          are used, therefore, include a file extension when using either 
  455.          of these options. 
  456.          
  457.                            Igate [<zone>:]<net>/<node> 
  458.                            Ogate [<zone>:]<net>/<node> 
  459.                             Gate [<zone>:]<net>/<node> 
  460.                             Hub [<zone>:]<net>/<node> 
  461.  
  462.          These options are for use in conjunction with SEAdog.  They 
  463.          effect the output of NODELIST.BBS and NODELIST.FON, if generated.  
  464.          They have no effect unless the 'Gated' keyword is used, as is 
  465.          required when generating a nodelist for use by SEAdog.
  466.  
  467.                     Password [<zone>:]<net>/<node> <password> 
  468.  
  469.          Example:  Password 1:3000/45 mypass 
  470.          
  471.          Used in conjunction with the 'Version5,' 'Version6,' 
  472.          'QuickBBSList' and 'BinkList' options, this allows the insertion 
  473.          of a password in the nodelist entry for a given node.  The 
  474.          password is used by Opus-CBCS and BinkleyTerm to password protect 
  475.          a network session.  This option has no effect on the NODELIST.BBS 
  476.          file, if one is being produced by ParseLst. 
  477.  
  478.          You must specify a node address and the password to be associated 
  479.          with that node. 
  480.          
  481.          The remote system must also have implemented the password 
  482.          feature, and the passwords must match in order for the session to 
  483.          be successful.  
  484.          
  485.          Refer to the documentation for your respective mailer or BBS for 
  486.          more information. 
  487.          
  488.                      Phone [<zone>:]<net>/<node> <number> 
  489.  
  490.          Example:  Phone 1:3000/45 1-303-555-9876 
  491.          
  492.          This tells ParseLst to substitute the phone number given in lieu 
  493.          of the one in the nodelist, for the node address given. You must 
  494.          give the replacement telephone number in its full form to allow 
  495.          other ParseLst configuration options to work correctly.  
  496.          
  497.          In the example above, regardless of the phone number listed for 
  498.          3000/45 in the nodelist, 1-303-555-9876 will be the phone number 
  499.          included for this node in any ParseLst output files. 
  500.          
  501.          This is handy for use with "unlisted" private nodes (when you 
  502.          know their phone number).  
  503.  
  504.          
  505.                                  ParseLst - Page 9
  506.  
  507.          CONFIGURATION FILE (Continued)
  508.          
  509.                      Baud [<zone>:]<net>/<node> <baud_rate> 
  510.  
  511.          Example:  Baud 1:3000/45 2400
  512.          
  513.          This tell ParseLst to substitute the baud rate given in lieu of 
  514.          the one in the nodelist, for the node address given. 
  515.          
  516.          In the example above, regardless of the baud rate listed for 
  517.          3000/45 in the nodelist, 2400 will be the baud rate included for 
  518.          this node in any ParseLst output files. 
  519.  
  520.                              CM [<zone>:]<net>/<node>
  521.  
  522.          Example:  CM 2:500/1
  523.  
  524.          This tells ParseLst to mark a node as #CM (continuous-mail 
  525.          capable, or "crashable"), even though it may not be listed as 
  526.          such in the raw nodelist. 
  527.  
  528.          This statement only applies when the 'Version6,' 'BinkList' or 
  529.          'QuickBBSList' statements are used.
  530.  
  531.          This option is primarily intended for temporary use where a node 
  532.          may not be listed correctly in the raw nodelist.  Use it 
  533.          carefully...trying to send mail during non-mail hours to systems 
  534.          that may not be able to accept it is inviting trouble. 
  535.  
  536.                         Dial [<domestic>][<international>]
  537.          
  538.          Example:  Dial 10777- 011-
  539.                         1-303-989-     989-      ; Local Dialing Area
  540.                         1-303-         1-        ; In-State, Non-Local
  541.                         1-913-         /-010     ; Special Case 
  542.                    End
  543.  
  544.          The 'Dial' statement begins a dial table, which is ended by an 
  545.          'End' statement.  
  546.          
  547.          The 'Dial' statement itself can take two parameters, the first of 
  548.          which is what is to be prepended to domestic telephone numbers, 
  549.          the second what is to be prepended to international telephone 
  550.          numbers.   These parameters are defaults, and are used when none 
  551.          of the dial table entries match a given telephone number.  
  552.  
  553.          Subsequent entries after the 'Dial' statement (but before the 
  554.          'End' statement) are used to change telephone number entries in 
  555.          the nodelist during processing.  The parameter on the left is the 
  556.          entry in the nodelist to match and replace, the one on the right 
  557.          is the parameter to change the matched to. 
  558.          
  559.          
  560.          
  561.                                  ParseLst - Page 10
  562.  
  563.          CONFIGURATION FILE (Continued)
  564.          
  565.          The table entries (as well as the 'Dial' statement parameters) 
  566.          take the form: 
  567.          
  568.               <prefix>
  569.               <prefix/suffix>
  570.               /<suffix>
  571.               /
  572.          
  573.          Prefix entries deal with the beginning of the phone number, 
  574.          suffix entries refer to the end of the phone number.  
  575.  
  576.          If a given phone number does not match any item in the dial 
  577.          table, then the default items in the DIAL statement are applied.  
  578.          In the example above, "10777-" would be added to the beginning of 
  579.          any domestic telephone number that does not match a dial table 
  580.          entry; "011-" would be added to international numbers that do not 
  581.          match an entry.  Note that since no forward slash was used (/), 
  582.          it is assumed that the entry will be a prefix, and is added to 
  583.          the beginning of the number. 
  584.          
  585.          In the dial table, the left argument is used to find a match, the 
  586.          right argument REPLACES that match.  In other words, the first 
  587.          argument means "match this and strip it from matching entries."  
  588.          The second argument means "add this to matching entries."  Any 
  589.          combination of prefix, suffix, or both can be used. 
  590.          
  591.          Above, the first dial table entry (labeled "Local Dialing Area") 
  592.          looks for any telephone numbers that begin with "1-303-989-" and 
  593.          changes the entry to begin with just "989-" instead.  In the 
  594.          third entry, telephone numbers that begin with "1-913-" will have 
  595.          that prefix stripped, and the telephone number will have "-010" 
  596.          appended to the end.  
  597.          
  598.          Some examples:
  599.          
  600.               1-213-555-1234
  601.          
  602.                    This number does not match any dial table entries, and 
  603.                    would be changed to 10777-1-213-555-1234.  The default 
  604.                    (on the 'Dial' line) says to add "10777-" to any 
  605.                    domestic telephone number that doesn't match a dial 
  606.                    table entry. An entry like this might be used as it is 
  607.                    here, to add a carrier access code to long distance 
  608.                    numbers. 
  609.  
  610.                    Had this number been international number, "011-" would 
  611.                    have been added to the beginning by default. 
  612.  
  613.          
  614.          
  615.          
  616.          
  617.                                  ParseLst - Page 11
  618.          
  619.          CONFIGURATION FILE (Continued)
  620.          
  621.               1-303-989-0000
  622.          
  623.                    This number would be changed to 989-0000.  The first 
  624.                    portion of this phone number, 1-303-989-, matches a 
  625.                    dial table entry.  The entry says to change matching 
  626.                    prefixes to the second parameter, in this case, simply 
  627.                    989-.  An entry like this is typically used for other 
  628.                    local nodes, since you don't need to dial "1" or the 
  629.                    area code for local numbers.  You'd need an entry like 
  630.                    this for EACH prefix in your local calling area. Note 
  631.                    that the dial table entries are processed in order.  
  632.                    This telephone number also matches the second dial 
  633.                    table entry in the example list, but since it already 
  634.                    matched a previous entry, subsequent matches are 
  635.                    ignored. 
  636.  
  637.               1-303-245-0000
  638.          
  639.                    This number would be changed to 1-245-0000.  The first 
  640.                    portion of this phone number, 1-303-, matches a dial 
  641.                    table entry.  The entry says to change the prefix shown 
  642.                    to simply 1-.  Typically, an entry like this would 
  643.                    follow the local calling area entries described above. 
  644.          
  645.               1-913-555-9876
  646.          
  647.                    This number would be changed to 555-9876-010.  The 
  648.                    prefix of this number matches a dial table entry.  The 
  649.                    entry says to replace the prefix with the given suffix 
  650.                    (the "/" character indicates a suffix).  This 
  651.                    particular entry has no practical use, but it 
  652.                    demonstrates that the first portion of a dial table 
  653.                    entry means to "strip" that from matching entries, and 
  654.                    replace it with the information shown in the last 
  655.                    portion of the dial table entry.  Any combination of 
  656.                    prefix, suffix or both can be used. 
  657.  
  658.                          Cost [<domestic>][<international>]
  659.  
  660.          Example:  Cost 25 325
  661.                         1-203-         17   ;Connecticut
  662.                         1-204-         100  ;Manitoba Canada
  663.                         1-214-         17   ;Texas
  664.                         1-303-230-     0    ;Local, Lakewood
  665.                         1-303-279-     0    ;Local, Golden
  666.                         1-303-340-     0    ;Local, Aurora
  667.                         1-303-         80   ;Colorado, Non-Local
  668.                         1-602-         20   ;Arizona
  669.                         33-56-         133  ;Bordeaux, France
  670.                         852-           238  ;Hong Kong
  671.                         354-           238  ;Iceland
  672.                    End
  673.                                  ParseLst - Page 12
  674.  
  675.          CONFIGURATION FILE (Continued)
  676.  
  677.          This statement marks the beginning of a cost table, which is 
  678.          ended with the 'End' statement.  The cost table is used to set 
  679.          the cost of dialing out to various areas that might be found in 
  680.          the nodelist. 
  681.  
  682.          The 'Cost' statement itself can take up to two arguments, the 
  683.          first being a default domestic cost, and the second being a 
  684.          default international cost.  These are used if no matches are 
  685.          found within the cost table for a given nodelist entry. 
  686.  
  687.          The entries between the 'Cost' statement and the 'End' statement 
  688.          make up the cost table, and define the amount in the lowest 
  689.          denomination of money in your area (in the United States and 
  690.          Canada, this would be cents, for example).  
  691.  
  692.          Like the dial table, the first entry is used to find matches in 
  693.          the nodelist.  The second entry is assigned as the cost for 
  694.          matching entries.  The cost table entries are used in the order 
  695.          that they appear in the table.  Once a match is found, no further 
  696.          matches are attempted. 
  697.  
  698.          Typically, the dial table lists domestic prefixes first, 
  699.          including a section devoted to your local calling area.  The 
  700.          latter portion is devoted to international prefixes, if 
  701.          applicable.  The sample table above is for a node in Denver, 
  702.          Colorado.  The sample, as well as your own cost table, will 
  703.          probably be much, much bigger. 
  704.  
  705.          Some examples:
  706.  
  707.               1-213-555-1234
  708.  
  709.                    This entry, a domestic call, does not match any of the 
  710.                    cost table entries.  The cost assigned to this entry is 
  711.                    25, the default domestic cost. 
  712.  
  713.               33-60-122331
  714.  
  715.                    This entry, an international call, does not match any 
  716.                    of the cost table entries.  The cost assigned to this 
  717.                    entry is 325, the default international cost. 
  718.  
  719.               1-303-228-1111
  720.  
  721.                    This entry is in the same state as the node using the 
  722.                    cost table, but it is not one of the entries shown as 
  723.                    being listed in the local calling area.  It is assigned 
  724.                    a cost of 80. 
  725.  
  726.          
  727.          
  728.          
  729.                                  ParseLst - Page 13
  730.  
  731.          CONFIGURATION FILE (Continued)
  732.          
  733.               1-303-279-0000
  734.  
  735.                    This number matches one of the entries listed as being 
  736.                    local, and is assigned a 0 cost.  
  737.  
  738.                                  Include <filename>
  739.  
  740.          Example:  Include altcmnds.txt
  741.  
  742.          This tells ParseLst to stop reading commands from the current 
  743.          file, and start reading them from the beginning of the named 
  744.          files.  Once the end of the file is reached, ParseLst will begin 
  745.          reading commands from the initial file again, starting at the 
  746.          command following the 'Include' statement that caused it to 
  747.          branch. 
  748.  
  749.          NODELIST GENERATION FOR YOUR SYSTEM
  750.  
  751.          The following table illustrates the statements that should be 
  752.          used to generate nodelist data files for listed systems.  Note 
  753.          that in most cases, ParseLst can create nodelist data files for 
  754.          more than one system simultaneously.
  755.  
  756.          System             Statements to Use
  757.          ------------------ ---------------------------------------------
  758.          BinkleyTerm 1.30-  NoNodelist Version5          Complete 
  759.          BinkleyTerm 1.30+  NoNodelist Version6          Complete UseZone
  760.          Fido 11w           NoNodelist Version5          Complete
  761.          Fido 12                                         Complete UseZone
  762.          Opus 1.0x          NoNodelist Version5          Complete
  763.          Opus 1.1x          NoNodelist Version6          Complete UseZone
  764.          QuickBBS           NoNodelist QuickBBSList      Complete UseZone
  765.          SEAdog             NoNodelist TBBSList          Gated
  766.          TBBS               NoNodelist TBBSList          Gated
  767.          TBBS w/BinkleyTerm NoNodelist TBBSList BinkList Complete UseZone
  768.  
  769.          NOTE!  The 'Gated' keyword may be used by ANY system to create a 
  770.          smaller finished nodelist that features only those nodes in your 
  771.          zone (and some administrative nodes in other zones).  
  772.          
  773.          
  774.          
  775.          
  776.          
  777.          
  778.          
  779.          
  780.          
  781.          
  782.          
  783.          
  784.          
  785.                                  ParseLst - Page 14
  786.  
  787.          COMMAND LINE PARAMETERS
  788.  
  789.          ParseLst offers a selection of command line options.  Note that 
  790.          the items in angle brackets below, <baud> excepted, represent a 
  791.          complete drive, path and filename designation.
  792.  
  793.               -e   
  794.          
  795.                    Let EditNL do the updating of the nodelist.  EditNL 
  796.                    must be available in the current directory.
  797.  
  798.               -n<nodelist>
  799.  
  800.                    Use <nodelist> as the nodelist to be processed.  
  801.  
  802.               -c<config>
  803.  
  804.                    Use <config> as the ParseLst configuration file.
  805.  
  806.               -m<mylist>
  807.  
  808.                    Use <mylist> as an additional nodelist.  This works the 
  809.                    same as the 'MyList' configuration file statement.
  810.  
  811.               -p<pvtlist>
  812.  
  813.                    Use <pvtlist> as an additional private nodelist.  This 
  814.                    works the same as the 'PvtList' configuration file 
  815.                    statement.
  816.  
  817.               -b<baud>
  818.  
  819.                    Use <baud> in place of the rate shown with the 'Baud' 
  820.                    configuration file statement.
  821.  
  822.          PRODUCT SUPPORT
  823.          
  824.          Since ParseLst is "freely available," direct product support, per 
  825.          se, is not available.  If you have problems or questions with 
  826.          ParseLst, you are welcome to send an inquiry to: 
  827.          
  828.               Alan Applegate, FidoNet 1:104/36
  829.               The Short Line Opus, Denver, Colorado, USA
  830.               (303)-969-9510
  831.          
  832.          You may also call directly (pre-registration via NetMail 
  833.          required; send name, mailing address, telephone and desired 
  834.          password).  A product support message area has been created to 
  835.          field questions regarding ParseLst. 
  836.          
  837.          Inquiries will be answered on a time-available basis only.  
  838.          Flames are never dignified with a response. 
  839.          
  840.          Thanks for using ParseLst!  Enjoy! 
  841.  
  842.